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Arrays are one type of data structure — a particular way of organizing 
memory allocations for a logical purpose of some kind. In the case of arrays, 
we allocate a number of cells one right after the other, and as we have seen, 
this gives us constant-time access to any one cell through the use of the 
“offset” concept of indexing. 

However, there are other data structures as well — other ways of organizing 
allocated memory which have different advantages. For example, what if you 
don’t know in advance the number of values you will have? 


Example: read in student grades until -1 is entered. 


Up until now, in such situations, our options would be: 


e Allocate very large array, so we can be sure to have enough room for all 
the values we need (wastes memory) 


e Allocate a smaller array, but if we exceed the size of that small array, 
then allocate a new, larger array and copy values over to the new array 
(wastes time) 


What is the solution? 


e What we want is a way of increasing storage gracefully, — using only as 
many cells as we need while being able to append new cells if we need 
them. 


e We can’t do this with arrays because once we allocate the array, some- 
thing else could have been allocated directly after it...and so there is no 
way to increase the array size once we have allocated it the first time. 
We’d have to allocate an entirely new array. 


e The way around this would appear to be to allocate new cells somewhere 
else, and then hold a reference to them indicating where the next chunk 
of cells is located. 


e Generalizing this idea, each cell can hold a reference to the next one. 
Then cells can be scattered all over memory and we can insert new 
cells whenever and wherever we want, and all we need to do is adjust 
references for a few cells. 


e This data structure is known as a linked list. 


Linked structures 


Unlike arrays, most data structures involve linking of some kind. Linked 
structures require the use of nodes or cells — small objects similar to individ- 
ual array cells, but containing references to other nodes in addition to the 
piece of information itself. This is possible because objects of class T can con- 
tain instance variables of type T (and those instance variables are, of course, 
references to other objects of type T), called links. 


public class NodeType 
az 


private NodeType myNodeReference ; 
} 
You can chain such nodes together in many different ways: 
e Linked list (top of p. 380 in KMR) 
e Tree (top of p. 381 in KMR) 
e Graph (middle of p. 381 in KMR) 


depending on the number of NodeType references in each node and how you 
choose to assign values to them. 


In CS225 you will study such structures extensively. In this class, we will 
only spend a bit of time looking at the idea of linked lists, which we will 
also call lists for short. In such a structure, the NodeType has exactly one 
reference to another NodeType. 


Lists 
(together with picture on board or at top of page 381) 


e As before, we will draw our objects as rectangles, and references as small 
boxes with arrows attached (we can also call them pointers, since they 
point to the object in question). 


e Also, recall from the last MP that you can store in a reference the value 
null, which is a standard value that can be compared to and which 
means “points to no object”. We will draw null references as small 
boxes with slashes through them, i.e. we won’t actually draw the arrow 
unless it points to something meaningful. 


This conceptual picture can be implemented as: 


e a number of small Node objects, contained within a larger List object 
which controls access to the Node objects, or 


e a List object consisting of the first value, and a reference to another list 
containing the rest of the values. 


We are going to stick with the second implementation, at least for now. It 
allows us to use recursion to simplify the concept, and also avoids the need 
to use nested classes. 


IntList (list of integers) defintion 


public class IntList 


< 
private int value; // value in cell 
// (first cell often 
// called ‘‘head’’ of list) 
private IntList tail; // reference to rest 
// of list 
public IntList(int v, IntList next) 
{ 
value = Vv; 
tail = next; 
} 
public int GetValue() 
{ 
return value; 
i; 
public IntList GetTail( 
ae 
return tail; 
iF 
} 


Constructing a one node list 


We would like to create a list containing one node, holding the integer 12. 
What should the “rest of the list” be? 


The answer: null. 


IntList singleCell; 
singleCell = new IntList(12, null); 


singleCell -> 12 -> null 


Now, we have a list that we can use as the tail of other lists! 


IntList list2; 
list2 = new IntList(19, singleCell) ; 


list2 --> 19 
x 
‘ 
| 
singleCell -> 12 -> null 


IntList list3; 
list3 = new IntList(1i, list2); 


Llist3--=> 1 
‘ 
\ 
al 


list2 --> 19 


SsingleCell -> 12 -> null 


// and so on, each earlier list being the tail 
// of the next one 


We don’t even need separate variable names for each node... 


IntList list; 

list = new IntList(12, null); 
list = new IntList(19, list); 
list = new IntList(1, list); 


In the code above, after line 1 list points to a single node holding 12 and 
null. 


last. =>: 12° -=> ‘nul 


At line 2, first a new node is created, holding a copy of 19 and a copy of the 
reference “list”... 


list -> 12 -> null 
/ | 
/ 
19 
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..and then the assignment is done (assignment is a low-priority operation), 
meaning that list can now point to what is returned by new — namely, the 
node 19. 


list 12 -> null 


19 
And likewise, after the third line, we get 
List.-> 1.-2:19 => 12--> null 


or if we want to list them visually in the code in forward order rather than 
reverse order... 


IntList list = 
new IntList(1, 
new IntList(19, 
new IntList(12, null))); 


Basically the same thing happens here, since you can’t run 
new IntList(1, ...) 


until you evaluate its second argument, 
new IntList(19, new IntList(12, null)) 

which you can’t run until you evaluate its second argument, 
new IntList(12, null) 


and therefore you get the same list as above. 
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Creating a linked list via user input 


The techniques from the end of last lecture made it very easy to append 
to the front of an existing linked list. If we can append to the front of an 
existing linked list easily, then we can read in a list in reverse quite easily. 

If we are reading in a list in reverse, then the first element we read in 
belongs at the end of the list, the second element we read in should then be 
appended to the front of that, the third element we read in should then be 
appended to the front of that, and so on. 
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public class ListTest 


{ 


public static void main(String args[]) 


{ 


IntList ourList; 


// assign the reference ourList to refer 
// to a list we read in in reverse 
ourList = ReadReverseList() ; 


// create a string consisting of 
// all elements in the list (we will 


// look at this code later) 
String listString = ourList.toString() ; 


System.out.println(listString) ; 
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public static IntList ReadReverseList () 


i 
int inputVal; 
IntList front = null; 
System.out.print("Enter number: "); 
inputVal = Keyboard.readInt() ; 
// eof stands for "end of file", which means 
// we have run out of data in the input file 
// we are reading (or reader has triggered 
// eof with a keyboard command if they are 
// entering data directly at the keyboard. 
// If eof( returns true, we are out of data. 
while (!Keyboard.eof()) 
{ 
// This line works just like the 
// list = new IntList(value, list) 
// lines from last lecture 
front = new IntList(inputVal, front) ; 
System.out.print("Enter number: "); 
inputVal = Keyboard.readInt () ; 
ds 
System. out.println() ; 
// Finally, return the reference so some reference 
// in main() can point to the first node of this list. 
return front; 
as 
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So, first we have 
front --> null 

Then, if we read in 3 as our first input value, we get 
front --> 3 --> null 

If we then read in 9 as our second input value, we get 
Tron. =—>.. 9) ==>. 3..->> null 

If we then read in 2 as our third input value, we get 
LYONt S20. S20 So 3S nid 


and so on, until we reach the end of the input file or until the user types 
the end of file key (which will be control-D, i.e. hold down the “control” key 
while typing the letter D). 
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Recursive methods to traverse linked lists 


What if you wanted to find the length of a list’? We will write an instance 
method of IntList to do this. 
Overall problem: find length of entire list 


public int Length() 


Recursive problem which we can assume a recursive call solves: find 
length of tail of list 


tail.Length(Q) ; 


How do we solve overall problem from recursive problem?: whatever 
the length of the tail of the list is, then adding 1 to that should take into 
account the first node as well (which is not part of the tail) and thus should 
be the correct length of the entire list. 


return 1 + tail.Length(); 


Base case: We don’t want to keep making recursive calls until tail is null and 
we are calling tail.Length() on a tail reference which is null, because you 
cannot invoke a method on a null reference without crashing your program. 
So, we should stop one step before that. That is, we should not go so far 
as to call Length() recursively on tail if tail is null; instead, tail being 
null should be our last case, i.e. our base case, since there is no recursive 
call from this case. And in the case of just one node (we have this, which 
has a value, but tail is null), the length is 1, so we should return 1. 
The full method, therefore, is: 


public int Length() 


ae 
if (tail == null) 
return 1; 
else 
return 1 + tail.Length() ; 
} 


16 


Since I can’t draw the “notecard” indicators of method calls here, I'll 
place a 1, 2, etc after all variable names to indicate they are part of the first 
recursive call, the second nested recursive call, and so on. 


ourList -> 1 -> 19 -> 12 -> 6 -> null 


“a 


main 
Make the call int x = ourList.Length() ;. Inside Length() we have: 


ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


| 
thisl 


and since the condition tail == null is equivalent to this.tail == nu1l, 
we are asking if the tail of the node whose value is 1 is null. But, it is not 
— clearly the tail of the node with value == 1 points to the node with value 
== 19. So, we take the recursive case, and say that the length of this list is 
equal to 1 + the length of the tail. This results in a second call to Length(). 


ourList -> i -> 19 -> 12 -> 6 -> null 
| 
this2 


And, 19’s tail is not null, so the length of this list is 1 plus the length of tail. 
Another recursive call is needed! 


ourList -> i -> 19 -> 12 -> 6 -> null 
| 
this3 


Likewise here...length of the list starting at 12 is equal to 1 plus the length 
of its tail, which is not null, so we make yet another recursive call. 
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ourList -> i -> 19 -> 12 -> 6 -> null 
| 
this4 


Here, tail is indeed null, so our base case kicks in and we return that the 
length of the list starting at 6 is 1. Clearly, this is the case (since null doesn’t 
count as a cell...though that was easier to see on the chalkboard drawings or 
the book drawings than it is here). 

So, we return the value 1 to the previous method. 


ourList -> i -> 19 -> 12 -> 6 -> null 
| 
this3 


Now, the length of the list starting at 12 was equal to 1 plus the length of 
its tail. The length of its tail was 1, as we just learned from the returned 
recursive call. So, we return 2 from this recursive call. 


ourList -> i -> 19 -> 12 -> 6 -> null 


| 
this2 


Now, the length of the list starting at 19 was equal to 1 plus the length of 
its tail. The length of its tail was 2, as we just learned from the returned 
recursive call. So, we return 3 from this recursive call. 


ourList -> 1 -> 19 -> 12 -> 6 -> null 


“a 


| 
this 


Now, the length of the list starting at 1 was equal to 1 plus the length of 
its tail. The length of its tail was 3, as we just learned from the returned 
recursive call. So, we return 4 from this recursive call. 
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ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


main 


And finally, the original call int x = ourList.Length() ; now has a result 
for the expression on the left-hand side of the assignment statement, namely 
4. So, x gets assigned the value 4. 
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What if we want to create a String made up of the list values one by one, 
separated by commas? 
Overall problem: read all list values into a String 


public String toString() 


Recursive problem which we can assume a recursive Call solves: read 
values in tail of list into a String 


tail.toString() ; 


How do we solve overall problem from recursive problem?: Whatever 
the String is which is made up of the elements in the tail of the list, we should 
be able to append our value onto the front. Actually, what we will want to 
do is append our value, a comma, and a space. 

The book handles this a bit more elegantly by using library functions to 
convert an integer to a String, but we will avoid them here by writing a 
blank space to the front of an integer to convert it to a String. This means 
we will always already have a blank space in front of the first integer in our 
String, though, so we really only need to append our first integer and a 
comma to the String returned by the recursive call. 


String myValue = " " + value; 
return myValue + "," + tail.toString() ; 


But those are just minor details. ‘The important concept here is, to get the 
overall String, find the String created from the list tail, and then append 
your front value onto it. 


Base case: Again, we don’t want to keep making recursive calls until tail is 
null and we are calling tail.toString() on a tail reference which is nu11, 
because you cannot invoke a method on a null reference without crashing 
your program. So, we should stop one step before that. That is, we should 
not go so far as to call toString() recursively on tail if tail is null; 
instead, tail being null should be our last case, i.e. our base case, since 
there is no recursive call from this case. And in the case of just one node, 
just create the String from that node’s value and return that String. 


String myValue = " " + value; 
return myValue; 
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Finally, we can put the entire method together. Note that for both the 
base case and the retun case, we have the line that creates a String from 
the value, so we can just type that once and place it before the if-else 
statement, rather than having that line occur within the if part and within 
the else part. 


public String toString() 


{ 
String myValue = " " + value; 
if (tail == null) 
return myValue; 
else 
return myValue + "," + tail.toString() ; 
t 
Example: 


OUTLASt. —>: a) => 19° => “12 =o 26 =F 
| 


main 


Note that toString() is an instance method, which means that when 
we invoke it via String s = ourList.toString(); we enter an instance 
method and have a this reference to the object referred to by ourList. 


ourList -> i -> 19 -> 12 -> 6 -> null 


| 
thisl 


Here, we first create a new String reference myValue which refers to a String 
object containing “ 1” and then since tail (i.e. this.tail) is not null, 
concatenate myValue with the result of calling toString () on the tail of this 
list. 
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ourList -> i -> 19 -> 12 -> 6 -> null 


| 
this2 
myValuel: ‘‘ 1’? 


Likewise here, we create “ 19” and then call recursively, since 19’s tail is not 
null. 


ourList -> i -> 19 -> 12 -> 6 -> null 


| 
this3 
myValuel: ‘‘ 1’? 
myValue2: ‘‘ 19’? 


Here, we create “ 12”, and then since 12’s tail is not null, we must call 
toString() recursively on 12’s tail before we know what to concatenate the 
“ 12” with. 


Ourkist. <S> dye DOr He. 2 See "6. > nul 
| 
this4 
myValuel: ‘‘ 1’? 
myValue2: ‘‘ 19’? 
myValue3: ‘‘ 12’? 


So, now that this.value == 6, we create the String object “ 6”... 


ourList =) cl =e lg: => 12) Se 36: => ult 
| 
this4 
myValuel: ‘‘ 1’? 
myValue2: ‘‘ 19’? 
myValue3: ‘‘ 12’? 
myValue4: ‘‘ 6’? 
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..and then, since tail is null here, we are at our base case and we return 
the fourth myValue, which is “ 6”. 


OurLAISst. Heb Aeon “a> 12. er G6: Seu 
| 
this4 
myValuel: ‘‘ 1’? 
myValue2: ‘‘ 19’? 
myValue3: ‘‘ 12’? 


Now, we take the third myValue, which is “ 12”, and concat with a comma 
“” and with the result of the recursive call, which is “ 6”, to get “ 12, 6”. 
Then we return that. 


ourList -> 1 -> 19 -> 12 -> 6 -> null 
| 
this3 
myValue1: ‘‘ 1’? 
myValue2: ‘‘ 19’? 


Now, we take the second myValue, which is “ 19”, and concat with a comma 
“” and with the result of the recursive call, which is “ 12, 6”, to get “ 19, 
12, 6”. Then we return that. 


ourList =>: 2. > D200 > 12 => +6 =>-null 
| 
thist 
myValuel: ‘‘ 1’? 


Now, we take the first myValue, which is “ 1”, and concat with a comma “,” 
and with the result of the recursive call, which is “ 19, 12, 6”, to get “1, 19, 
12, 6”. Then we return that. 


ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


main 
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Finally, the call String s = ourList.toString() ; is complete, and s is 
assigned the String object “1, 19, 12, 6”. 


So, looking back on the main way above, with the reading of values in reverse, 
if we sent in the items 3, 9, 2, -6, 56, and EOF via the keyboard, we’d get 
the following output: 


Enter number: 3 

Enter number: 9 

Enter number: 2 

Enter number: -6 

Enter number: 56 

Enter number: “~D <-- "control-D" equals EOF 
56, —63. 2,.-95. 3 
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What about finding the nth element? We will conceptually number ele- 
ments starting with 0, so if we pass 0 to the nth-element method, we get a 
reference to the list starting with 1. If we pass 1 to the nth-element method, 
we get a reference to the list starting with 19. If we pass 2 to the nth-element 
method, we get a reference to the list starting with 12. And so on. 

ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


| 
main 0 Hl 2 3 


If the n we pass is too large — for example, if we ask for element 4 or 5 in the 
list above — then since we can’t return a reference to a particular list node 
we should instead return the null reference. 

Overall problem: find the nth element in the full list. 


public IntList nth(int n) 


Recursive problem which we can assume a recursive call solves: 
finding the appropriate element from the list tail. However, we can’t just say 
“find the nth element in the list tail”, because if you were at your initial call: 


ourList -> i -> 19 -> 12 -> 6 -> null 


0 J 2 3 
and you called nth recursively, you would have this situation: 


ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


| 
this2 


0 1 2 


That is, since there are not definite integers attached to your list cells, the 
only way you know which conceptual integer is attached to your list cell is to 
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start counting from the start of the list. And, if on your recursive call, your 
list begins at 19 (as seen above), then from the standpoint of that recursive 
call, 19 is element 0, 12 is element 1, etc. 

Or, in other words, if you want element 2 in the full list, then you want 
element 1 in the list which is the tail of the first element, and you want 
element 0 in the list which is that list’s tail. If you want element 3 from the 
overall list, then that is the same as asking for element 2 from the tail of that 
list, and that is the same as asking for element 1 in the tail of that list, and 
so on. 

So, our recursive call should send n-1 as an argument, so that if we were 
looking for element n in the overall list, we look for element n-1 in the tail 
of that list. 


tail .nth(n-1); 


How do we solve overall problem from recursive problem?: This 
problem is far more straightforward — in any case, we are returning a reference 
to the node we are looking for, so once we find the value, then return a 
reference to that value. When we obtain the result from our recursive call, 
just return that directly without doing anything else. 


return tail.nth(n-1) ; 


Base case: In a way, we have two base cases here. First, we have our by- 
now-typical base case, where we do something special if tail is null. In this 
case, if tail is null, we are saying to search a non-existent list for its first 
element, or its second element, or whatever. We said in the original problem 
description that if the value we were looking for exceeded the final index, 
then we return null. So, that is what we will return here. 


if (tail == null) 
return null; 


The other base case concerns if we are actually at the value we want. If the 
value we want is in the tail of our current node, then we recursively search 
the tail. However, it might not be in the tail of our current node; instead it 
could be the value of our current node. By definition, that will only happen 
when n is 0, since if n is anything larger than 0, it means the position is 
located in the list tail. And if our current node 7s what we want, then return 
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a reference to that node, which is this since we are dealing with an instance 


method. 


if (n==0) 
return this; 


Putting it all together... 


public IntList nth(int n) 
{ 
if (n==0) 
return this; 
else if (tail == null) 
return null; 
else 
return tail.nth(n-1); 


Example: 


ourList -> i -> 19 -> 12 


“a 


main 


And the call would be ourList.nth(2) ; 


ourList -> i -> 19 -> 12 


“a 


this1 
nl = 2 
Conceptual 
node numbering 
starting from 
node referred 
to by this: 0 at 


—> 6 -> null 


—> 6 -> null 


Is n 0? No. So, return the result of calling nth recursively with an argument 


decremented by 1. 
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ourList -> i -> 19 -> 12 -> 6 -> null 


Conceptual 
node numbering 
starting from 
node referred 
to by this: 


| 
this2 
n2 = 1 


Is n 0? No. So, return the result of calling nth recursively with an argument 


decremented by 1. 


ourList -> Il 


Conceptual 
node numbering 
starting from 
node referred 
to by this: 


—-> 19 -—-> 12 -> 6 -> null 
| 
this3 
n3 = 0 
0 1 


Isn 0? Yes. So return the this of the third recursive call. 
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ourList -> i -> 19 -> 12 -> 6 -> null 


this2 
n2=1 
Conceptual 
node numbering 
starting from 
node referred 
to by this: 0 1 Z 


We were returned a reference to 12. Return that reference. 


ourList -> i -> 19 -> 12 -> 6 -> null 


this1 
ni=2 
Conceptual 
node numbering 
starting from 
node referred 
to by this: 0 1 2 3 


We were returned a reference to 12. Return that reference. 


OurLast —>: 1 => 19° —> A2: => -6 =>-nvll 


“a 


main 


And the call ourList.nth(2); results in a reference to the node holding 12, 
which is the node associated with “2” in this list (assuming you start counting 
with 0). 
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Methods to alter linked lists 


Given the list from last lecture: 


ourList -> 1 -> 19 -> 12 -> 6 -> null 


main 


how would we go about appending to the end of that list’? How would we go 
about appending to the end of a list in general? 
Overall problem: append to end of the overall list 


public void addToEnd(int n) 


Recursive problem which we can assume a recursive call solves: 
append to end of the tail of list. To do this, we simply pass the value along 
to the tail, effectively saying that since we want to append to the very end of 
the list, and since there are nodes in the tail, that means we want to append 
this value to the end of the tail, and so we'll let the tail itself take care of 
that. 


tail .addToEnd(n) ; 


How do we solve overall problem from recursive problem?: There is 
quite literally nothing else to do once we make the recursive call. We are not 
returning anything, so we don’t even have a return here. We simply pass the 
value to the tail and say, “here, you deal with this” and that is the end of 
things. 

Base case: As usual, the base case would be when tail is null; in this method, 
that is because if tail is null, there is no smaller list to pass the add task off 
to. We must addToEnd here because we don’t have a tail that can take care 
of the addition of a node for us. But, since we don’t have a tail, then we are 
at the end of the list, and value is the final value in the list. Therefore, if 
we are trying to add to the end of the list, that means the new value we are 
trying to add should be the tail of this node, and that value’s tail should be 
null. 


tail = new IntList(n, null); 
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Putting it all together, we get: 


public void addToEnd(int n) 


{ 
if (tail == null) 
tail = new IntList(n, null); 
else 
tail.addToEnd(n) ; 
} 


Example: 


ourList -> i -> 19 -> 12 -> 6 -> null 


main 


Our call from main could be ourList.addToEnd(14);. Again, this is an 
instance method. 


ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


| 
thisl 
ni = 14 


The variable n is always going to be the same for all the recursive calls, 
but we'll notate it above anyway. Here, tail is not null, so we recursively 
attempt to insert 14 into the tail of the list. 


ourList -> i -> 19 -> 12 -> 6 -> null 
| 


this2 
n2 = 14 


Again, tail is not null, so make another recursive call to insert 14 into the 
tail of the list. 
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ourList -> i -> 19 -> 12 -> 6 -> null 


| 
this3 
n3 = 14 


Again, tail is not null, so make another recursive call to insert 14 into the 
tail of the list. 


ourList -> i -> 19 -> 12 -> 6 -> null 


“a 


| 
this4 
n4 = 14 


Here, tail is indeed null, so we take the base case instead of the recursive 
case. That means we face a two-step process. First, create the new node... 


OUrLIsSt. =>: dt) => 19° => 12 => <6 “=> 


“a 


| 
this4 14-->null 


..and then this.tail should be assigned to refer to it. 
OurLise. “=>° 2 =<), [90 o> 120 =e “Go ce 
° \ 
| aN 
this4 14-->null 


If we clean up that picture a bit, we get: 


ourList —-> 1 -> 19 -> 12 -> 6 -> 14 -> null 


this4 
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And then, we start returning from the recursive calls one by one, but there 
is never anything more to do in those recursive calls, so for all practical 
purposes, we are now finished — after having successfully inserted 14 at the 
end of this list. 
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A somewhat harder problem is to insert into sorted order in a list. To do 
this, we would have to assume that the list itself was already in sorted order, 
or the task would make no sense. So, given a list in sorted order, insert a 
new value into the appropriate spot — whether it should be inserted as the 
first node, a middle node, or the last node — and return a reference to the 
new list. 

Why do we return a reference to the new list? Well, think of what could 
happen if we insert into the front of a list. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


main 


If we insert 19, then ourList can go on pointing to 8 with not much problem 
(though we are ignoring for the moment the problems with inserting 19 into 
its proper spot recursively): 


OUrLIst. -s¢0. =2° 15. ss 19° a> 21°-> 25.0 31 > null 


main 
But, if we were to insert 2, then ourList should point to 2, not 8. 


ourList -> 2 -> 8 -> 15 -> 19 -> 21 -> 25 -> 31 -> null 


main 


Since the node containing 2 is not created until we actually call this “insert- 
in-sorted-order” instance method, and since if we don’t save the location of 
that node in some reference, we lose it, if we simply create and attach the 
node containing 2, and then return nothing we will not be able to overwrite 
the value currently in ourList with the location of the node containing 2, 
and so we get: 
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OurLast.=>-6° —> 415. —> 19: => -21 -—> -25:. =>-31.-=> null 


where 2 refers to 8, but ourList doesn’t know about it. So, we return a 
reference to the changed list, so that whatever reference is pointing to the 
head of this list can now be set to point to the head of this new list via a call 
such as: 


ourList = ourList.addInOrder (2) ; 


When such a line is run, perhaps ourList ends up pointing to a new node, 
perhaps not. But, we are prepared either way. 

Overall problem: Insert n into sorted order in the overall list and return a 
reference to the changed list. 


public IntList addInOrder(int n) 


Recursive problem which we can assume a recursive call solves: 
Well, probably something dealing with the tail, right? Certainly. In partic- 
ular, here we would be dealing with inserting n into sorted order in the tail 
and returning a reference to the changed tail. 


tail .addInOrder(n) ; 


How do we solve overall problem from recursive problem?: Well, if 
we had to change our tail by inserting into 7t, that is similar to the call from 
main above, where we had to write the reference returned by the resultant 
call back into ourList. Here, if we had inserted, say, 14 into the example list 
above, well, from 8’s point of view, that is resulting in a change of its tail: 


from: 
ourList -> 8 —> 15 -> 19 -> 21 -> 25 -> 31 -> null 
to: 
ourList -> 8 —-> 14 -> 15 -> 19 -> 21 -> 25 -> 31 -> null 
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and so naturally, we should reassign 8’s tail to point to the new list created 
by inserting 14 into its tail. That is, we should reassign 8’s tail to the result 
of the recursive call. In general, if we insert in sorted order into our own tail, 
we should then have our own tail reference point to the resultant list rather 
than the old list, since the resultant tail list might have required the new 
value get attached at the start of itself, and in that case if our tail contines to 
point to the node it has been pointing to, that would be incorrect. It should 
instead point to the new node. So, we reassign tail either way, and then we 
just need to make sure we always return the first node in the list, whether old 
or new. But then again, that is what we had to do anyway when returning 
back to main — return a reference to our first node, whether an old node or 
a new node. 


tail = tail.addInOrder(n) ; 


Of course, once we correctly set our tail, since we inserted into the tail of our 
current node, our current node (i.e. this) is still the first node of this list. 
So, we should return that in this case. So the full recursive case is: 


tail = tail.addInOrder(n) ; 
return this; 


Base case: We have three possible stopping cases here. If we need to insert 
into the tail, but tail is null (i.e. there is no tail list), then this becomes 
an insert-at-end case, and we can handle it just as we did in the previous 
method we discussed. The one addition to this would be that we always 
want to return the first node of our resultant list. If we change our current 
node’s tail from pointing to null to pointing to a newly-created node, then 
our current node (i.e. this) therefore remains the front node of this list 
(since we inserted in the tail — ie. after our value — rather than before our 
value), and so we should return a reference to that front node of the list, i.e. 
we should a return a reference to our current node. 


if (tail == null) 
{ 


tail = new IntList(n, null); 
return this; 
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However, perhaps we don’t care whether tail is null or not, since we are 
not inserting into the tail. Perhaps we insert before our first element, rather 
than after it. In that case, we need to create a new node holding the new 
element, and that new node should point to our existing list. That is, if we 
are inserting as the first node, then naturally, the rest of the list should be the 
tail of this node. That means the reference of this new node — i.e. the tail 
of this new node — should refer to the old head node of the list. Meaning, it 
should refer to this. 


if (n < value) 
new IntList(n, this); 


Of course, right now the new node’s location isn’t being stored in any refer- 
ence. We will fix that in a moment. But, the new node will hold the new 
value n, and its tail will then be all the other nodes of the existing list...which 
makes sense since if this node is to be the new first node, then all the other 
nodes should come after it. 

As far as what to return, we need to return a reference to the first node 
of the overall list after the insertion. Here, the first node of the list after 
the insertion is the new first node! So, we should return a reference to the 
new first node, which we can do simply be returning the result of the new 
operation. The final code for this case, then, is: 


if (n < value) 
return new IntList(n, this); 


Our third case (first case being tail==null1, second case beingn < value) 
is a case we can choose to deal with in a number of ways. The case is the 
situation where n==value, i.e. when we are trying to insert an element that 
happens to already be in the list. The way we will deal with this is by not 
allowing the insertion, i.e. the value is already there so we’re done without 
having to create a new node. (You could also insert a second copy of the value 
into the list, but we are not going to do that here.) In that case, your reference 
to the first node of the list — i.e., your this reference — should be returned, 
since you are now done with your insertion (without doing anything!) and 
this refers to the first node in the list. 


else if (n==value) 
return this; 


37 


Putting it all together, we want to make sure we check the less than and 
equal cases before the tail case, because if we want to insert as first node, that 
gets done whether tail is null or not, and if we want to ignore the insertion 
due to finding a duplicate, that gets done whether tail is null or not. This 
gives us: 


public IntList addInOrder(int n) 


aA 
if (n < value) 
return new IntList(n, this); 
else if (n==value) 
return this; 
else if (tail == null) 
a 
tail = new IntList(n, null); 
return this; 
a 
else 
{ 
tail = tail.addInOrder(n) ; 
return this; 
} 
af 
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Example 1: Inserting 2 into original list. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


main 


ourList = ourList.addInOrder (2) ; 


As before, though n will not change as we traverse down the list, we will 
record it anyway, along with the this references of our various recursive 
calls. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 
| 
thistl 
ni = 2 


Here, n < value is true (because 2 < 8) and so we hit the first case of our 
method. In this case, there are two steps. First, the new operation will create 
a new node containing value equal to 2 and tail equal to this... 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


“a 


/\ | 
/ this1 
2 nil=2 


..and then we return a reference to that new node containing 2, so that back 


in main, ourList gets reassigned to refer to that new node. 


ourList 8H > 15 > (21 > 25) => 31. > null 
| 2s 
| ‘al 
4 
sae? 


And we are done! 
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Example 2: Inserting 23 into original list. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


main 


ourList = ourList.addInOrder (23) ; 


We begin our first recursive call. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 
| 
thisi 
ni = 23 


The parameter n is not less than or equal to value, and tail is not null, 
so we enter the fourth case, where we assign tail to the result of the re- 
cursive call. To do this, we first need to run the recursive call, which is 
tail.addInOrder (23) ; and is our second recursive call. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 
| 
this2 
n2 = 23 


The parameter n is not less than or equal to value, and tail is not null, 
so we enter the fourth case, where we assign tail to the result of the re- 
cursive call. To do this, we first need to run the recursive call, which is 
tail.addInOrder (23) ; and is our third recursive call. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


“a 


| 
this3 
n3 = 23 
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The parameter n is not less than or equal to value, and tail is not null, 
so we enter the fourth case, where we assign tail to the result of the re- 
cursive call. To do this, we first need to run the recursive call, which is 
tail.addInOrder (23) ; and is our fourth recursive call. 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 
| 
this4 
n4 = 23 


Here, n < value is true (because 23 < 25) and so we hit the first case of 
our method. In this case, there are two steps. First, the new operation will 
create a new node containing value equal to 23 and tail equal to this... 


ourList -> 8 -> 15 -> 21 -> 25 -> 31 -> null 


“a 


/\ | 
/ this4 
23 n4 = 23 


..and then we return a reference to that new node containing 23, so that 
back in the previous method, the reference which formerly pointed to 25 will 
now point to the new first node of that list, 23. 


ourList -> 8 -> 15 -> 21 ----- > 25 -> 31 -> null 
| | 
}. | 
this3 | 
n3 = 23 *--> 23 


Above, we are back in the third recursive function, and the reference with 

the asterisk is what was returned by the fourth recursive function. So, we have 
completed the tail .addInOrder (23) ; portion ofthe tail = tail.addInOrder (23) ; 
call, and now we assign tail to what was returned. 
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ourList -> 8 -> 15 -> 21 20 => 31 => nals 
~ \ 2 
ieee | 
EX | 
this3 \ | 
n3 = 23 => 23 


Finally, as part of that fourth case, we not only assign tail to the result of 
a recursive call, but also return this. 


ourList -> 8 -> 15 -> 21 25 a> oS nad 
- ~ \ 2 
| | \ | 
/ * \ | 
this2 \ | 
n2 = 23 => 23 


Above, we are back in the second recursive call, and the asterisk indicates 
the reference returned by the prior recursive call. We now set tail to refer 
to the same node as that reference. Note that nothing changes there, since 
we are saying 15 should be set to point to 21 but it in fact already does point 
to 21, so the assignment doesn’t change anything. This gives the list below. 


ourList -> 8 -> 15 -> 21 25 -> 31 -> null 
i \ - 
| \ | 
/ \ | 
this2 \ | 
n2 = 23 => 23 


Finally, since we were in the fourth case here, we not only reassign tail 
(which changed nothing here) but we also return this. 


ourList -> 8 -> 15 -> 21 26 =o) Ol<=> Dud 
és a \ . 
| | \ | 
/ * \ | 
this1 \ | 
ni = 23 a> '23 


Above, we are back in the first recursive call, with the asterisk indicated the 
reference returned by the second recursive call. Again, since we are finishing 
up step 4, we now assign tail to refer to the result of the recursive call. This 
means tail is reassigned to point to 15...but tail already pointed to 15, so 
nothing changes there, either. 

And finally, we return this — a reference to 8 — back to the main method... 


ourList -> 8 -> 15 -> 21 25 -> 31. -> null 
e \ 4 
| \ | 
* \ | 
main x | 
=>°23 


..and assign ourList to refer to the same node as the returned reference 
(indicated by asterisk). But, it already pointed to 8, so setting it to point to 
8 doesn’t change anything. Thus, we have: 


ourList -> 8 -> 15 -> 21 26°=> 31 °-> "null 
. 2 
\ | 
\ | 
main \ | 
-> 23 


and clearly we have successfully inserted 23 in order into the list. 


You could also go through an example where you insert at the end. You’d 
have a lot of times where you set tail to point to a node it was already 
pointing to, but other than that, it would be basically the same as running 
through an example of addToEnd from the earlier part of these notes. 
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